home *** CD-ROM | disk | FTP | other *** search
/ Chip 2004 May / CMCD0504.ISO / Software / Freeware / Programare / dspack / DSPACK231.exe / {app} / include / wmsdkvalidate.h < prev    next >
Encoding:
C/C++ Source or Header  |  2002-10-24  |  2.3 KB  |  62 lines

  1. //*@@@+++@@@@******************************************************************
  2. //
  3. // Microsoft Windows Media
  4. // Copyright (C) Microsoft Corporation. All rights reserved.
  5. //
  6. //*@@@---@@@@******************************************************************
  7. //
  8. #pragma once
  9. #ifndef _WMSDK_VALIDATE_H
  10. #define _WMSDK_VALIDATE_H
  11.  
  12. //
  13. // This routine examines the file extension in the URL or file name that is passed
  14. // in as an argument.  The routine returns S_OK if the file extension is included in a
  15. // set of file extensions that the SDK is typically able to handle. or NS_E_INVALID_NAME
  16. // if the file extension is not included in that set.
  17. //
  18. // This routine cannot be used to determine with absolute certainty if the SDK can
  19. // handle a particular URL, as this cannot be known until the URL is opened.
  20. //
  21.  
  22. HRESULT STDMETHODCALLTYPE WMCheckURLExtension( /* [in] */ LPCWSTR pwszURL );
  23.  
  24. //
  25. // This routine examines the URL scheme that is passed in as an argument.  The routine
  26. // returns S_OK if the URL scheme is included in a set of URL schemes that the SDK is
  27. // typically able to handle. or NS_E_INVALID_NAME if the URL scheme is not included in
  28. // that set.
  29. //
  30. // This routine cannot be used to determine with absolute certainty if the SDK can
  31. // handle a particular URL, as this cannot be known until the URL is opened.
  32. //
  33.  
  34. HRESULT STDMETHODCALLTYPE WMCheckURLScheme( /* [in] */ LPCWSTR pwszURLScheme );
  35.  
  36. //
  37. // This routine returns S_OK if the data buffer looks like a file type that is supported
  38. // by the SDK.  It returns NS_E_INVALID_DATA if the data buffer cannot be handled by the SDK.
  39. // This routine may return a false positive, but will not return a false negative.
  40. //
  41.  
  42. HRESULT STDMETHODCALLTYPE WMValidateData(
  43.     /* [in] */ BYTE *pbData,
  44.     /* [in, out] */ DWORD *pdwDataSize
  45.     );
  46.  
  47. //
  48. // This routine validates that a URL can be played in Offline mode.
  49. // The parameter pwszLanguage can be set to a RFC-1766 language ID, or to NULL if
  50. // any language is acceptable.
  51. // The output parameter pfIsAvailableOffline is set to TRUE if the URL can be
  52. // played in Offline mode.
  53. //
  54.  
  55. HRESULT STDMETHODCALLTYPE WMIsAvailableOffline(
  56.     /* [in] */ LPCWSTR pwszURL,
  57.     /* [in] */ LPCWSTR pwszLanguage,
  58.     /* [out] */ BOOL *pfIsAvailableOffline
  59.     );
  60.  
  61. #endif /* _WMSDK_VALIDATE_H */
  62.